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1. INTRODUCTION 


1.1 Object 


This document describes the Graphical User Interface of D’Fusion Studio. A quick start guide is also included to 
get you started with D’Fusion Studio. 


1.2 External documentation 


1.2.1 Reference documents 
[01] D’Fusion Studio - User Guide, Total Immersion 
DFusion Studio - User Guide.pdf 


[02] D’Fusion Augmented Reality - Reference Manual, Total Immersion 
DFusion AR - Reference Manual.pdf 


[03] D’Fusion Augmented Reality - Lua API, Total Immersion 
DFusion AR - Lua API.pdf 


[04] D’Fusion Augmented Reality - Physics Plugin, Total Immersion 
DFusion AR - Physics Plugin.pdf 


[05] D’Fusion Computer Vision - Reference Manual, Total Immersion 
DFusion CV - Reference Manual.pdf 


[06] D’Fusion Exporter for Maya - User Manual, Total Immersion 
DFusion Exporter for Maya - User Guide.pdf 


[07] D’Fusion Exporter for Maya - Modeling Constraints, Total Immersion 
DFusion Exporter for Maya - Modeling Constraints.pdf 


[08] D’Fusion Exporter for 3dsMax - User manual, Total Immersion 
DFusion Exporter for 3dsMax - User Guide.pdf 


[09] D’Fusion Exporter for 3dsMax - Modeling Constraints, Total Immersion 
DFusion Exporter for 3dsMax - Modeling Constraints.pdf 


1.2.2 Other documents 


[10] LUA 5.1 Reference Manual 
www.lua.org/manual/5.1 
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1.3 Glossary & Acronyms 


TI Total Immersion 
AR Augmented Reality 
MLT MarkerLess Tracking 
CV Computer Vision 


1.4 Presentation rules 


Presentation Content 


XXXXXXXX File name 
wor Script : code samples 
XO00OOXK Key word 


Reminder : main information of the chapter 


XXXXXXXXX User Interface Command 

XXXXXXXX Keyboard key 
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2. QUICK START 


When you open D’Fusion Studio, you get this: 


WW D'Fusion Studio Lo | © {mn Soma 


File Edit Add Project Tools Application ? 


= oe e wt @Home All Platforms 


Object editor 
O viewpor [Authoring Camera] Custor 


Lua Editor 


Select object <none> 


TOTAL IMMERSION a” D'Fusion® Studio 


\project\ 


D me S O NM Recent files: 


Comenercial Ur 
TOTAL Int al 


Outliner Create anew project Load an existing project 


Name Type Module VY scene0 
L 


viewport viewport scene_0 camera 
timeline timeline scene_0 
scene_0 scene scene_0 


camera camera scene_0 


Hierarchy manager Log view 


The startup dialog lets you choose between loading a recent project, browsing for a specific project or creating a 
new project. If you choose to create a new project, you will be asked to save your new scene file. The directory 
where you save your project will be considered as the project directory (i.e. the one used by default to save all 
your project files). 
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{J D'Fusion Studio 
Add Project Tools Application 


re Ole 2H, 


Object editor 


Organize v New folder 


sx Saaamen [~ Date modified 
Wl Desktop 
i jescoda 
ib Downloads 
“S| Recent Places 


r Dropbox 


Libraries 

| Documents 
—— @ Music 
(ee) Pictures 
& Videos +e 


Outliner 


viewport 


timeline 


scene _0 Filename: [eas 


camera Save ast D'Fusion Project = 


* Hide Folders 


A scene with a camera, a viewport and a timeline is created. You will be able to review information about your 
scene (objects, hierarchy and properties) from the different panels. 
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File Edit Add Project Tools Application 


-* eo = pa @Home All Platforms 


Object editor 
O viewport [Authoring Camera] Custor 


Select object <none> 


Solution Explorer 


Current directory: C:\Users\jescoda\My AR Projects\Getting Started Tutorial\project\ 


Current scenario: project.dpd 
View type: File system are & > 4 


Name Size Date modified 
project 
L B proj... 1.562 Ko 31/08/2011 17:33:14 


Outliner Hierarchy manager 


Name Type Module Y scene0 
L 


viewport viewport scene_0 camera 
timeline timeline scene_0 
scene_0 scene scene_0 


camera camera scene_0 


Hierarchy manager Log view 


The D’Fusion Studio interface is modular, so you can move panels and dock them wherever you want within the 
main interface, or undock them to have floating windows; their size and position are saved when you quit the 
application and stored for your next session. 
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F 
ij D'Fusion Studio 


File Edit Add Tools 


ee Die 


Lua Editor 


Select object <none> 


Timeline 


Application 


Current directory: C:\Users\jescoda\My AR Projects\project\ 
Current scenario: 


View type: 


project.dpd 
File system 


@ (jw) & 


Name Size Date modified 


VY & project 


LB x0 


1.562 Ko 31/08/2011 17:49:02 


Name Type 


viewport viewport scene_0 


timeline timeline scene_0 


scene_0 scene scene_0 


camera camera scene_0 


Now, you can add new entities to your scene. But first, import resource files into your project directory. 


VY scene0 


camera 


Gware generate: 


Open the “Solution Explorer” window and click on the “Import directory” button. 
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Wj D’Fusion Studio 


File Edit Add Project Tools Application 


«wi bie 2 > All Platforms 


Solution Explorer 
viewpor camera 


Lua Editor 


Current directory: C:\Users\jescoda\My AR Projects\project\ 


Current scenario: + project.dpd 


Timeline 


View type: File system 


Name 


ba! project 


L B project.dpd 1.562 Ko 31/08/2011 17:49:02 


Solution Explorer Object editor 


Outliner Hierarchy manager 


Name Type Module VY scene0 
L 


viewport viewport scene _0 camera 
timeline timeline scene_0 
scene_0 scene scene_0 


camera camera scene_0 


+ UU? UTILS, VALYUMUI UMU) Woo IcoCcL, tcveI 2 
: HW! Direct3D Device successfully restored., level 2 
: D3D9 device: Ox[D6A0F6A0] was reset, level 2 
: U1! Direct3D Device successfully restored., level 2 
: D3D9 device: Ox[O6A0F6A0] was reset, level 2 


Configuration 


Select the directory that contains the media you want import. Imported files are then copied into the project 
directory and appear in the “Solution Explorer”. 


Include files according to the target/platform of your application. 
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{i D’Fusion Studio 


Project Tools Application 


«3 os CF All Platforms 


Solution Explorer 
viewpor 


Lua Editor 


Current directory: C:\Users\jescoda\My AR Projects\project\ 

Current scenario: — project.dpd 

View type: File system are & x 
Size Date modified 


Copy file path 
Select first object with this resource 


Open in Lua Editor 


Include in export list 


Solution Explorer Objecté Exclude from export list 


Outliner Edit resource properties ete! 


Name Type Module VY scene 0 
viewport viewport scene_0 camera 
timeline timeline scene_0 

scene_0 scene scene_0 


camera camera scene_0 Log view 
Log 


VORL . YU? UCVILE. VALYUMYI UMY] WOS ICoCl, ItCvecl 2 
OGRE : !!! Direct3D Device successfully restored., level 2 
OGRE : D3D9 device: 0x[06A0F6A0] was reset, level 2 
OGRE : !!! Direct3D Device successfully restored., level 2 
OGRE : D3D9 device: 0x[06A0F6A0] was reset, level 2 


Configuration 


Now, drag and drop the .mesh file from the Solution explorer to the viewport window to create a new “Entity”. 
The object is visible in the “Outliner” and its properties in the “Object Editor”. 
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Mj D'Fusion Studio 


File Edit Add Project Tools Application § 


-4 eo « 2/7 @Home All Platforms 


Solution Explorer 
O viewpor camera 


Lua Editor 


Current directory: C:\Users\jescoda\My AR Projects\project\ 


Current scenario:  project.dpd 
View type: File system B) fs & x 


Name i Date modified 
Vv 
Vv 


Timeline 


project 
geom 


B geom.mat 0 octets 31/08/2011 18:26:48 


Solution Explorer Object editor 


Outliner Hierarchy manager 


Name Type Module VY scene0 
Ie 


viewport viewport scene_0 camera 
timeline timeline scene _0 
scene_0 scene scene_0 


camera camera scene_0 
Log 


VORL . Vo? UCVILE,. VALYUMU WOsd ICOCL, CVC 2 
OGRE : !!! Direct3D Device successfully restored., level 2 
OGRE : D3D9 device: O0x[O6A0F6A0] was reset, level 2 
OGRE : !!! Direct3D Device successfully restored., level 2 
OGRE : D3D9 device: Ox[06A0F6A0] was reset, level 2 


Configuration 


After you imported your first object, you will notice you still cannot see anything. You actually need a light in your 
scene. Add a new light with the menu “Add > Effects > Light”. 


You still don’t see anything? You may now need to move your objects from the default position. When created, all 
objects are centered in the scene origin, at (0, 0, 0). So your light cannot illuminate your object correctly for the 
moment. 


Go into the panel “Object Editor”: the top combo-box lets you browse all the objects of your scene to edit their 
properties. Select the camera (default camera is simply called “camera”) and move it at position (0, 0, 10). You 
can go farther if your object is bigger of course. Then select the light you created and move it away from the 
object also. 
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ij D’Fusion Studio 


File Edit Add Project Tools Application ? 


= s Ff ey, All Platforms 


Object editor 
CO) viewpor camera 


Lua Editor 


Select object entity 


Mot For 


Carremerrial Loe 


Type: entity 
Restore initial values 


D'Fusion’ 


Parent: scene_0 


Visible w 


(omen 7 aaa 
Solution Explorer Object editor 


Outliner Hierarchy manager 


Name Type Module Vv scene0 


viewport viewport scene_0 camera 
timeline timeline scene 0 


scene_0 scene scene_0 


camera camera scene_0 
Log 


VONL . MISS. LUGUITY U. FST s yoouwua yy Arn 
Projects \project\geom\geom.mesh., level 2 

OGRE : WARNING: C:\Users\jescoda\My AR 

Projects \project\geom\geom.mesh is an older format 

([MeshSerializer_v 1.40]); you should upgrade it as soon as possible using 


Configuration 


You see the “Object Editor” panel is not surrounded with an orange line. This line indicates that the current value 
of your object has been modified. Objects in Studio have an initial value, which is, for all the parameters of the 
object, the start-up value when you launch the scene. When you will save, this is the value written to file. This 
important notion lets you modify your scene or play it without altering the possibility to save a modification on 
one object. 


If you save your file now, the saved position will be (0, 0, 0) not (0, 5, 5). To save initial values of the current 
object, simply push the “Set initial values” button. The surrounding line will disappear to indicate that your 
object’s current values now match the initial values. 


After that, you can adjust the camera’s point of view with the mouse in the 3D view. At the top of the 3D view, a 
dropdown list let you choose, for each viewport, an authoring camera to visualize your scene. Authoring cameras 
are here to help you place and visualize your scene during edition without actually moving around the scene 
camera. These controls are not accessible when the scene is playing. 


You can edit camera’s point of view with wheel mouse (traveling), Alt + Middle button (panning), Alt + 
Left button (trackball). Trackball is only available for custom and current camera. 


(J) viewport [Authoring Camera] Custom 


You can also adjust the positions and orientations of objects directly in the 3D view when you activate 
manipulators. 
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i) D’Fusion Studio 


File Edit Add Project Tools Application 


3D manipulators toolbar 
All Platforms 


Object editor — 
CO®) viewpor camera 


Lua Editor 


Select object entity 


3D manipulator 
Type: entity 


Restore initial values 


Timeline 


Edit Object Name ... 


Parent: scene_0 "F 4 : 
Visible w D -USION 


Corrremarrcial Uae 


hes ee een) 


Solution Explorer |Object editor 


Outliner Hierarchy manager 


Name Type Module camera 
viewport viewport scene_0 

timeline timeline scene_0 light1 
scene_0 scene scene_0 

light light scene_0 Log view 


‘entity ety scene. gs 


camera camera scene_0 


VORL . VGII tL Goon HiaLtciian Voinunvuvy _OIauit Wy OUULITULYy UI 
DFuzion/Core/Entity/000000 10 because this Material does not exist. 
Have you forgotten to define it in a .material script?, level 2 

OGRE :; Texture: Ti_GridTex. tga: Loading 1 

faces(PF_A8R8G8B8, 128x128x1) with hardware generated mipmaps 


Configuration 


Drag parts of the manipulator with left mouse button to modify position, orientation or scale of your object. 
Now that your 3D objects are correctly positioned, you may want to add some behavior to your scene by adding a 
script. 


Select the Add, Script menu. As for importing object, a dialog box will pop-up to let you specify the script name 
and its resource. You don’t directly specify a module like for an entity here, you choose the script owner, which 
may be any kind of object in your scene. You can either select an existing file which will be imported or give a 
new name which will create an empty script. In both cases, your file must be under the main project file directory. 


So create a new script and select scene_00 (this is default name of your scene) as owner. 
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Lua Editor 


Timeline 


File Edit Add Project 


Solution Explorer 


Current directory: C:\Users\jescod:ff 


Current scenario: — project.dpd 


View type: File system 


Name 
project 
geom 
lia geom.mat 
B geom.mesh 
= tn-ee 


Solution Explorer Object editor 


Outliner 


Name Type 
viewport viewport 
timeline timeline 
scene_0 scene 
lightl light 


camera camera 


aw wh ile 2 <> 


D’Fusion® Studio 
GUI User Guide 


All Platforms 


CO viewpor camera 


a a 


Resource file ja\My AR Projects\project\my_lua.lua 


Cancel 


Projects \project\geom\DemoRobot\, level 2” 
OGRE : Unloading unused resources in resource group TI/EFUSION, level 


OGRE : Finished unloading unused resources in resource group 


21/09/12 


Now select your script in the Object Editor, check the “trigger” option in order to execute the script as soon as the 
scene is played. Click the “Set initial values” button to be sure it will be saved. 


Your script is actually empty. To you need to edit it to add some behavior. You can either click the “Open in 
Editor” button in the Object Editor, or right click in the outliner on your script and select the menu “Open in Lua 
Editor”. In both cases, it will open your script in Lua Editor and switch to this panel. 


Enter some behavior and save your script. 
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i D’Fusion Studio 
File ells Display Debug 


Studio 


my_lua.lua 
tlocal scene = getCurrentScene() 
2 local geom = Entity(scene:getObjectByName ("entity") ) 
S local stepX = 0.0 
S local inc = 0.1 
a 


6 repeat 
stepX = stepX + inc 


Lua Editor 


if stepX > 0.5 or stepX < -5.0 then 
inc = inc * -1.0 
end 


geom:setPosition(stepX, 9, 0) 
@ until coroutine.yield() 


Call Stack Find Results 


Function 


Reset your scene to force reload of the script file. 


Push the play button! 
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3. STUDIO PANEL 


i] D'Fusion Studio 


File Edit Add Project Tools Application ? 
=) > iil | ae ell { Dl le 2] 


CI® viewport Vv) camera 


Studio 


Lua Editor 


VY scene0 


L 


camera 


Timeline 


Select object <none> 


Name Type 


viewport viewport scene_0 


OGRE : !!! Direct3D Device successfully timeline timeline scene_0 

restored., level 2 

OGRE : D3D9 device: 0x[063CF6A0] was scene_0 scene scene_0 ...8\project\project.dpd 
= See SRR Re L myscript luascript scene_0 ...ts\project\my_lua.lua 


camera camera scene_0 


3.1 Menu 


3.1.1 File 


New Ctr1l+N Create a new scenario project. A dialog is opened to save the new .dpd file. 
Load Ctr1+0O Load a project. 
Save Ctr1lt+s Saves your project (overwrite the current .dpd file). All objects are reset to 


their initial values. 


Save as Ctrl+Shift+S — Save the current scene with a specified filename. All objects are reset to 
their initial values 


Recent files Lists the 4 latest opened files. Click on one element to open the 
corresponding scene. 
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Close the application 


Undo the last modification in the Studio panel 


Redo the last modification in the Studio panel. 


Exit 
3.1.2 Edit 
Undo Ctrl+Z 
Redo Ctrl+y 
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3.1.3 Add 


Add an ew object in your scene: 


3D Elements: 


D’Fusion® Studio 


, 21/09/12 
GUI User Guide 


All 3D elements are positioned at (0, 0, 0). 


You can add: 
Empty 3D object 


Module 
Entity 
Scenette 
Rendering: 
Camera 
Viewport 
Rendertexture 
2D Elements: 
Videocapture 
Videotexture 
Texture 
Text2D 
Overlay 


Effects: 
Light 
Particle 


Sound 


Script: 


You can specify a .lua file. 
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A 3D node. This type of object has no associated resource file. It 
can be mainly used to group objects in the 3D hierarchy. 


An empty module 
Imports a 3D Entity. You must select the corresponding .mesh file. 


Imports a scenette. You must select the corresponding .scene file. 


You can optionally specify a configuration file 
You must specify valid rendertarget and camera parameters 
Creates a new renderTexture. 


You can specify a video configuration file (.xml) 
Creates a texture based on an existing video capture. 
Import a 2D Texture. You must specify the input file. 
Creates a new 2D Text object. 


Imports an overlay object. You must specify the overlay template 
and the .overlay Ogre file. 


To add point, directional or spot light in your scene 


Imports a particle system, you must specify the particle system 
name and the “.particle” Ogre file. 


Imports a .wav or .ogg file 
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3.1.4 Application 


3.1.4.1 Preferences 


Open preferences dialog 


e General 


General 


Edition 


Interface 


3D View 


D’Fusion® Studio 
GUI User Guide 


~ Fixed size 


Height 


Di 


( changes will take effect the next time you start 
D'Fusion AR Studio) 


21/09/12 


You can adjust the size of the main 3D View. This size is totally independent from final window size of 


your scenario. 


If the "Fixed size" option is checked, the 3D view has exactly the size defined in this dialog and is not 


scalable. 


If the "Fixed size" option is unchecked, the 3D View is scalable but keeps the ratio of your final 
application window (You can adjust the final application window's size in Project > Settings > Rendering) 


The rasterizer option allows you to choose between Direct3D9, OpenGL and OpenGL ES 2 for the render. 
For this option, changes will take effects the next time you start D'Fusion Studio. 
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e Edition 


Translation step 0.10 Scale step 


Other step 0.10 


Mouse wheel behaviour 


You can adjust the edition steps of several types of spin boxes here. 
Wheel mouse behavior: You can choose among three behaviors for the mouse wheel: 


Standard The mouse wheel changes value of spinbox as soon as mouse 
cursor is above the spinbox 
Ignore wheel The mouse wheel never changes values of spinbox 
Edit with wheel and Ctrl The mouse wheel changes value of spinbox if you click on the 
spinbox and press Ctrl Key 
e Interface 
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General 


Edition 


You can choose to apply the standard style to the application. 
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e 3D View 


1 Edit preferences... 


General 
Edition 
iitetace Grid unit 
3D View Grid subdivisions 

Manipulator screen size (in pixels) 


Camera widget scale 


Light widget scale 


Grid unit Unit of one subdivision of the grid (in Ogre unity) 

Grid subdivisions Number of subdivisions. A value of 10 will create a 10x10 square 
grid. 

Manipulator screen size 3D manipulators (translation, rotation, scale) have constant screen 


size. You can adjust this size (in pixels) here 


Camera widget scale A selected camera is represented by a special object in the 3D 
view. You can adjust the size of the camera object 


Light widget scale A selected light is represented by a special object in the 3D view. 
You can adjust the size of the light object 
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3.1.4.2 Windows 


The Windows menu allows you to show/hide specific windows. A check symbol means that the window is 
visible. 


314.3 Emulation Settings 


Open a dialog for emulation settings. If the scenario is developed for a mobile platform, this dialog can be useful 
to configure the behaviour of some hardware devices. 


w Dev available 


Emulated 


Standard configuration Mobile configuration 


If scene is playing, cl 


Cancel 


Emulated Device is emulated. If you emulate keyboard (or mouse/joystick) 
and use it physically (press a key), values are not catched by 
D'Fusion. Use the macro manager to configure values sent by 
emulated devices. 


Device not available The device will not be available in Lua script. 


Standard configuration Keyboard, mouse and joysticks are not emulated. Accelerometer, 
compass, gps and touchscreen are not available. 


Mobile configuration Accelerometer, compass, gps and touchscreen are emulated. 
Keyboard, mouse and joysticks are emulated and not available. 
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3.1.5 Project Settings 


These settings are the settings saved with your current project. Depending on the context of your application (in 


Studio, in a Standalone player, or in a web player) these settings will not always have the same role. See related 
documentation for more information. 


e Application 


Application 
Icon Resource 


Rendering 


Title 


Cancel 


Icon resource This parameter lets you specify a customized icon for the final 
application. The icon must be a valid image file (.ico for example). 
This setting only have an impact in a Standalone player 


Title Specifies the Title of the Standalone player main window. It has 
no effect in any other cases. 
e Rendering 
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Application 
eae FullScreen Width 


Rendering 


Vertical Sync ~ Height 
FullScreen Rate 1) Antialiasing 


Rasterizer Platform Default 


Cancel 


Fullscreen Check this option if you want your scene to start fullscreen. This setting is 
always efficient in the scene configuration. 

Vertical sync This value controls the vertical synchronization of rendering operations. True by 
default 

FullScreenRate Full screen refresh rate. Usually set to 0 (unspecified). 

Width Controls width of the desired resolution for the final application main window. 

Height Controls height of the desired resolution for the final application main window. 

Antialiasing This parameter controls the desired antialiasing value for the final application. 

Rasterizer This value controls the renderer used by our graphic engine. As for today, two 


renderers are available: direct3D9, OpenGL and OpenGL ES 2. You can also 
choose “Platform Default” (recommended) as the default renderer may be 
different depending on the platform. 


3.1.6 Export 


Configure and export your scenario. For more information on the export process, please see chapter 3.11 
“Export” of the current document. 
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3.2 Toolbar 


3.2.1 Scene toolbar 


Play/resume scene. Object's values are not updated at each frame. 


Pause scene. Objects created dynamically (in scripts) are displayed in the user 
interface. 


Reset all objects with their initial values 


3.2.2 3D view toolbar 


[es G Display a XZ grid. The aspect of this grid can be configured in the preferences 
dialog 
Eq T Display translation manipulator on the selected object. 
i 
fe) R Display rotation manipulator on the selected object. 
ea s Display scale manipulator on the selected object. 
i 


Only one transform is available at time. 


Activate target mode. This mode is only available with lights and cameras and 
forces the selected object to look at the target widget. 


Q 


3.2.3 Current target & platform 


All Platforms 


You can set the current target and platform. You can add or delete targets and platforms. Each target/platform 
can have different included files (defined in Solution Explorer). 
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3.3 Outliner 


Outliner 


Name Type Resource 


scene_0 scene 


L myScript luascript scene _| E:\Dev\ Tests\test\myScript.lua 


A\ light light 
entity entity scene 0 E:\Dev\Tests\test\Geom\Geom.mesh 


camera camera scene_0 


This panel lists all the objects of the scene. For each object, their type, their module and their resource file are 
also displayed. 


You can also visualize and modify script links with objects in this panel. If you want to modify the owner of a 
script, simply drag and drop the script to his new owner. 


The warning icon appears if the object has been modified (by you or by the execution of a script). This icon stays 
until you click on the Object Editor "Set Initial Values" button for the selected object, or until you click on the 
main Studio "Reset" button. 


You can activate a contextual menu by right clicking on any object: 


Edit properties Shows the object editor 

Activate viewer Only available for entity and scenette, open the 3D Viewer panel 
and display selected object. 

Open in Lua editor Only available for script objects; opens the script file in the Lua 
Editor and toggle to it. 

Delete Deletes current object. When you delete an_ object, all 
dependencies of this object will also be deleted (3D hierarchy for 
example). 
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3.4 Hierarchy manager 


Hierarchy manager 


YW scene_00 
Grid 
Frame 
Geom 
Y mod 
Vv Camera 
LLights 


This view represents the 3D hierarchy of your scene. Only 3D objects appear in this view thus. You can modify the 
hierarchy here by drag and dropping the items. Notice that this will modify the initial values of the object whose 
hierarchy has been modified, and will be saved only if initial value is applied (in Object Editor) 


You cannot move an object from a module to its parent module. 
You can activate a contextual menu by right clicking on any object: 


Activate viewer Only available for entity and scenette, open the 3D Viewer panel 
and display selected object. If the selected object is a scenette, it 
disappears from the Studio panel and is displayed in the 3D 
Viewer . Scenette re-appears when the 3D Viewer panel is closed 


Delete Delete current object. Children are also deleted 
Edit properties Show the object editor 
IMMERSION ® +33 (0) 1 46 25 97 42 
& www.t-immersion.com 


D’Fusion® Studio 


TOTAL IMMERSION «7 <%” eed 21/09/12 


3.5 Object editor 


Object editor 


Select object Light1 


Type: light 
Restore initial values Set initial values 


Edit Object Name ... 


Parent Camera 
Visible v 
Position 


Local World 


In this panel, you can select and edit all the objects of your scene. Accessible parameters depend on the type of 
the selected object. 


Initial values are values of all parameters at the load of the scene. When scene is saved all objects restore their 
initial values. 


For example, a cube is positioned at (0, 0, 0). Scene is played, a script move the cube to (1, 0, 0). Then, scene is 
paused. (0, 0, 0) is the initial value of cube’s position and (1, 0, 0) is its current value. When you reset the scene, 
cube recovers its initial values so its (0, 0, 0) initial position. 


If an object is not in its initial state, panel's border color is orange. 


Set initial value Register current displayed values as initial values for the current 
object 

Restore initial values Restore initial values for the current object 

Edit Object Name You can change the name of the current object. Two objects 


cannot have same name 
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3.5.1 Object3D 


Parent: scene_0 


W orld 


x 0.000 


y 0.000 


0.000 


0.000 


Visible Let you specify if the object is rendered. 
Position The standard 3D position of an object. You can adjust the position 
in world or local coordinates. 
Orientation The standard 3D orientation of an object. You can adjust the 
orientation in world or local coordinates. 
Scale You can apply scales on your object. 
Uniform Force scale to be uniform. If you 


change scale of one axis, others 
axis are updated too. 


Be aware of Ogre behavior with non uniform scales, please refer 
to the media documentation. REPHRASE, PLEASE!! 
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3.5.2 Entity 


Resource file \Dev\Tests\TestAR 2\trunk\1-Objects\1-Objet3D\s ym/Geom.mesh 


Alternative platform 
Render group 50 Visibility mask -1 
Cast shadows ¥ 


Bouding box 


Resource file The .mesh file used for this entity 
Alternative platform Let you define alternative .mesh file. 
Render group This is the rendering option that let you modify rendering 


priorities. Higher values are used for foreground object, lower 
values for background. Objects in the same group are of course 
rendered using the usual Z-Order sorting. 


Visibility mask Applies a visibility mask to this object. 
Cast shadows Let you specify that this object should cast a shadow. 
Bounding box Let you specify that the bounding box is displayed. 


3.5.3 Scenette 


Resource file AR Objects \6-Scenette \Scenette 1\srcs\sc\Ville/xpt_villeO2.scene 


Alternative platform 


Visibility mask 


Resource file The .scene used by this scenette. 
Alternative platform Let you define alternative .scene file. 
Visibility mask Applies a visibility mask to this object. 


3.5.4 Scene 


Ambient 


Shadow technique 


Ambient Color of the ambient light 

Shadow technique Shadow technique used for the scene 
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3.5.5 Light 


Type 


enabled v 


Color 


Attenuation 

Range Constant 

Linear 0.00 Quadratic 
Power scale 


Cast shadows Vv 


Shadow camera setup Default 


3.5.5.4 General parameters 


Type Depending of the type chosen, following parameters may apply or 
not. 

Enabled You can disable a light by deactivating this option. 

Power scale 

Cast shadows If this option is checked, shadows will be calculated from this 
light. 

Shadow camera setup When rendering texture shadows, you can specify a light to use a 


custom shadow camera with this setting. 


35,52 Color 
Diffuse RGB values for the diffuse color. 
Specular RGB values for the specular color. 
3.9:5.3 Attenuation 


By default there is not attenuation on lights. You can however apply a standard attenuation computation on spot 
and point lights. (attenuation doesn't make sense on a directional light which position is not relevant). 


Range The upper range of the light 
Constant Constant attenuation factor 
Linear Linear attenuation factor 
Quadratic Quadratic attenuation factor 


3204 Spot 


Inner range It sets the angle covered by the spot inner cone. 
Outer range It sets the angle covered by the spot outer cone. 
Fallof It sets the falloff between inner and outer cone of the spot light. 
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3.5.6 Camera 


Near clip distance } Far dip distance 


FOVy 45.00 Aspect ratio 1.33 


Calibration file 
Alternative platform 
Calibrate 


Near clip distance The near clip of a camera is the distance under which object will 
not be rendered. 


Far clip distance The far clip of a camera is the distance under which object will not 
be rendered. 


FOVy Let you override the Field Of View y angle (in radians) of the 
camera. Be aware that this setting is constrained by the model of 
the camera if specified. If you set this parameter, it will thus 
override the model value. 


Aspect ratio Let you override the aspect ratio of the camera. Be aware that 
this setting is constrained by the model of the camera if specified. 
If you set this parameter, it will thus override the model value. 


Calibration file The file parameter, as derived from Object, is used in Camera to 
set the model of the camera. Models are XML files, with important 
information used to configure the rendering made from this 
camera so that virtual object and real world match perfectly when 
a live stream is used as background input. 


Alternative platform Let you define alternative calibration files. 
Calibrate Open the (camera) Calibration panel. 
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3.5.7 Particles 


Resource file 


Partides name 


Render group 


Visibility mask 


Start on play 


Resource file 
Alternative platform 


Particles name 


Start on play 
k\3-Rendering \5-Partides\srcs\sc\smoke.partide 


Alternative platform 


Set this parameter to true if you want the particles to play when 
the scenario is launched. 


Refers to particles resource .particle file. 
Let you define alternative .particle file. 


The name of the particle system in the .particle file. 


Render group This is the rendering option that let you modify rendering 
priorities. Higher values are used for foreground object, lower 
values for background. Object in the same group are of course 
rendered using the usual Z-order sorting. 

Visibility mask Applies a visibility mask to this object. 
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3.5.8 RenderTexture 


RenderTarget 


Update priority 


Pre-Render script 


Post-Render script 


Pixel format 


Update priority 


Enabled scipts during edition 


Pre-Render script 


Post-Render script 


D’Fusion® Studio 


Swap buffers ¥ 


Enabled scripts during edition 
c\preRender. lua 


-} 


Enabled v Open in editor 


\3-Rendering\4-ShaderWat 


Enabled v Open in editor 


PF_R8G8B8 


Let you specify a priority which indicates in which order all the 
custom render targets will be rendered, which might be necessary 
if some use the result of some others. 


If the option is activated, pre and post render script are executed 
even if the scenario is not playing. 


On rendering operations with different render target, you may 
need to customize your scene for each single operation differently. 
For this purpose, you can attach a script which will be called 
before the rendering of each single target with this parameter. 
The parameter must be the name of an existing script 


Like previous parameter, this let you customize your scene on 
rendering operation for each target. This script will be executed 
right after the rendering operation of the render target, generally 
to restore things modified by the pre-render script. 


Width Width of the texture. 
Height Height of the texture. 
FSAA Level of multi-sample anti-aliasing used for this render texture. 
Pixel format Format used for the texture 
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3.5.9 Overlay 


Height 


Visibility mask 


Scheme Default 


Enabled scripts during edition 


ScrollX You can use this parameter to move the overlay. Values are in 
relative mode (left side of “screen” : 0, right side : 1) 

ScrollY You can use this parameter to move the overlay. Values are in 
relative mode (top of “screen”: 0, bottom : 1) 

ScaleX You can use this parameter to scale the overlay. Scale’s center is 
overlay’s center. 

ScaleY You can use this parameter to scale the overlay. Scale’s center is 
overlay’s center. 

Rotation Rotation of the overlay in degrees. Rotation’s center is overlay’s 
center. 

Visible You can use this parameter to turn the overlay visible or invisible. 

Z-Order If you have several overlays, you can use this parameter to 
determine which one is displayed on top. Values between 0 and 
650 are valid. 

Visibility mask Applies a visibility mask to this object. 

Resource file Reference to the resource file of this overlay. It must be a valid 
‘overlay’ Ogre format file. 

Alternative platform Let you define a alternative .overlay file. 

Overlay name Name of the Overlay to instantiate in the ‘.overlay’ file. 

Is a copy If you create two overlays or more, with the same 


file/overlayname combination and uncheck "is a copy" option, 
these overlays are linked (it means that if you scroll one overlay, 
the second is scrolled also) 
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3.5.10 Text2D 


Visibility mask 


mode 


Position 


alignment 


top 


Format 


Font 


char Height 


space Width 


Colour Top 


Colour Bottom 


Value 


Metrics Mode 


Left 


Top 


Char height 


Spacewidth 


Fontname 
Colour 
Colour bottom 
Colour top 


Text alignment 


Show 


Visibility mask 


TOTAL 
IMMERSION 


Displayed text 


Unit used for all numeric parameters. Possible values are ‘relative’ 
or ‘pixel’. In relative mode, values are between 0.0 and 1.0. (left 
side of “screen” : 0, right side : 1) 


You can use this parameter to move the text on the screen. 
Values’ unit depends on ‘metricsmode’ parameter. 


You can use this parameter to move the text on the screen. 
Values’ unit depends on ‘metricsmode’ parameter. 


Font’s size. Values’ unit depends on ‘metricsmode’ parameter. 
Values’ unit depend on ‘metricsmode’ parameter 


Space between characters. Values’ unit depend on ‘metricsmode’ 
parameter 


Font used for displaying text. 

Text’s colour. 

Color of the text’s bottom part. 

Color of the text’s top part. 

You can use this parameter to align the text. Possible values are 
‘left’, ‘right’ and ‘center’. 

You can use this parameter to turn the text visible or invisible on 
startup. 

Applies a visibility mask to this object. 
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3.5.11 Script 


sts \TestAR 2\trunk\1-Objects \1-Objet3D \srcs\sc\moveObject.lua 


New Parameter 


Input 


Priority 


Framerate 0.00 


Type: Input Value type: String 
’ 2 


Open in Editor 


Enabled 


Priority 
Trigger 


Framerate 


Pause 


New parameter 


If this parameter is set to false, the script will be disabled, 
preventing any execution before being re-enabled by the engine 
(via another script for example). 


Priority manages order of execution of scripts. 


This parameter is a shortcut to force triggering execution of the 
script on launch of the scenario. 


A script can stay active over time in D’Fusion engine, using the 
yield() function. In the default case, it will thus be executed once 
for each frame. In some cases, the user might want the script to 
be executed at a lower framerate. This parameter is a helper to 
simulate a delay between 2 executions of the script. If you give a 
framerate of 2 for example, eg you would like the script to be 
executed 2 times per second, once the script is executed it will be 
planned for execution after a delay of 0.5 seconds on the timeline, 
instead of being planned on the very next frame. 


With the management of timeline, the resulting real delay will 
always be equal or superior to this delay, resulting in a real 
framerate always inferior or equal. Notice this method is just a 
helper, and the framerate resulting might not be constant. 


This parameter is usefull only if the ‘trigger’ parameter is set to 
true. In this case, the script can be paused before being executed. 


If you click on this button, a new script parameter is created 


Type Type of the new parameter 
Value type Value type of the new parameter 
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3.5.12 Videocapture 


Parameters 
Master 
Loop 


AutoPlay ¥ 


Select Dialog Y 
Compat Dialog ¥ 


Save Config 


Configuration €E:\Dev\Tests\TestAR2\trunk\1-Objects ewpor c\VideoCam.xm 


Alternative platform 
Edit A 


Master Specifies this capture is the Master of this scenario, meaning 
everything is synchronized to this input. There can be only one 
Master per scene. 
Loop Will make the video loop if the video is a file. This flag has no 
effect on a live capture 
AutoPlay Set this parameter to true if you want the videocapture to play 
when the scenario is launched. 
Select dialog This enables a selection dialog to pop up when the default 
configuration does not match a valid video input 
Compact dialog This flag modify appearance of the selection dialog. When 
checked, a compact dialog with minimum choices will show 
Save config When checked, this flag will cause the local configuration be 
saved. It can prevent the selection dialog to pop up on each 
launch 
Configuration Videocapture configuration file. (XML file) 
Alternative platform Let you define alternative videocapture configurations 
Device Let you select directly the camera amongst available devices 
Num Driver Let you select directly the drive of the requested capture device 
VidCapID ? 
Video Tool Open the Video panel. 
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3.5.13 Texture 


Resource file E:\Dev\Tests| 


Gamma 
Mipmaps 
Texture type 
Pixel format 


Alpha texture 


Hardware gamma correction 


Resource file Texture file 

Alternative platform Let you define alternative texture file 

Gamma Sets the gamma adjustment factor applied to this texture on 
loading the data. 

Mipmaps Sets the number of mipmaps to be used for this texture. 

Texture type Type of texture. 

Pixel format Format used for the texture: 

Alpha texture This parameter is used if a greyscale texture must be used as an 


alpha texture. 


Hardware gamma correction Sets whether this texture will be set up so that on sampling it, 
hardware gamma correction is applied. This option is only 
supported on recent hardware. 


3.5.14 VideoTexture 


Video capture 


Video capture The parameter must be the name of an existing videocapture 
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Enabled scripts during edition 


ev \Tests \TestAR 2\trunk\1-Objects\3-Viewports\srcs\sc\preVp2.lua 


Enabled 


Open in editor 


‘v\Tests \TestAR 2\trunk\1-Objects\3-Viewports\srcs\sc\postVp2.lua 


Enabled v Open in editor 


alpha 


Texture left 0.00 


Texture height 1.00 


This field indicates with which camera the rendering will be made 


The render target of the viewport. 

Top of the viewport in the render Target, as relative value. 
Left of the viewport in the render Target, as relative value. 
Width of the viewport in the render Target, as relative value. 
Height of the viewport in the render Target, as relative value. 


If you have several viewports, you can use this parameter to 
determine which one is displayed on top. 


Let you specify the visibility mask used by this viewport. 


3.5.15 Viewport 
Camera camera2 
Target <Main View > 
Top 
Width 
Z-Order 
Visibility mask 
Scheme Default 
Pre-Render script 
Post-Render script 
Background color 
Background texture videoTex2 
Texture top 0.00 
Texture width 1.00 
Camera 
on this viewport. 
Target 
Top 
Left 
Width 
Height 
Z-Order 
Visibility mask 
Scheme 


Enabled scripts during edition 


Pre-Render script 


The notion of scheme is used by Ogre render engine to modulate 
rendering for a single material depending on context. Please refer 
to Ogre documentation for more information. 


If the option is activated, pre and post render script are executed 
even if the scenario is not playing. 


On rendering operations with different viewports, you may need 
to customize your scene for each single operation differently. For 
this purpose, you can attach a script which will be called before 
the rendering of each single viewport with this parameter. The 
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parameter must be the name of an existing script 


Post-Render script Like previous parameter, this let you customize your scene on 
rendering operation for each target. This script will be executed 
right after the rendering operation of the render target, generally 
to restore things modified by the pre-render script. 


Background color Specifies the RBGA color value of the background. 

Alpha Specifies the RBGA color value of the background. This value has 
no influence 

Background texture Specifies the texture used as background. 

Texture top Top coordinate of the background as relative value. 

Texture left Left coordinate the background as relative value. 

Texture width Width of the background as relative value. 

Texture height Height of the background as relative value. 


3.5.16 Sound 


Resource file k\1-Objects\10-Sound\03-MultipleSound\srcs\sc\02_Coda.oagg 


Alternative platform 
Predefined FX 


Loop 


Spatialize 


Resource file Sound file 


Spatialize Lets you define if the sound is spatialized or not. When 
spatialized, the 3D position of the sound is used and the sound is 
adjusted related to the camera position and orientation. 


Loop Makes the sound loop. 


Predefined FX Specify an effect to apply to the sound among a set of predefined 
effects. These effects may include echo, distortion, etc. (but be 
aware that they may not all work on all platforms). 
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3.6 Log View 
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Clean log 


Configuration 


In the “log” tab of this panel, you can read all messages sent by D’Fusion. You can filter messages by channel 
and severity in the configuration tab. 


Log 


Configuration 


Channels : 


dfusion2 Debug 


ogre Trace 


loading_info Error 


lua Critical 
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3.7 3D View (viewport) 


(COB) viewport [Authoring Camera] Custom 


The 3D view allows the visualization of the scenario, and provides a set of tools to select and manipulate the 3D 
objects of the scene. 


3.7.1 Visualization 


For each viewport of your scene, a set of authoring cameras are available to help you visualize your scene or 
parts of it. These cameras are part of the authoring tool and will not appear in your saved scenario of course. 
Default points of view are Top, Bottom, Left, Right, Front, Back and Perspective. There is also a “custom camera” 
which is mainly useful to move around your scene without affecting your scene camera. 


To move the current point of view, you can use actions below: 


Traveling Wheel mouse 
Panning Alt key + Middle button 
Trackball Alt key + Left button 


Display a white rectangle on the current viewport 
Select a viewport in order to modify the authoring camera 


[Authoring Camera] Custom Select a camera for the current viewport. Select an 
authoring camera does not modify current viewport 
parameters 


Ca) Reset authoring cameras to their initial position and 
orientation. No-authoring cameras are not reset 


In the 3D view, cameras and lights have 3D representations to help you position them. This custom objects do 
not appear neither in your final scenario. 
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3.7.2 Select object 
To select an object: Right click on the object in the 3D view. 


3.7.3 Transform object 


To transform an object: 
e Activate one transform mode (translation, rotation, scale) in the toolbar 
e Inthe 3D view, press left button and move the mouse to drag a part of the manipulator. 


e If you want validate the transform, release left button (else right click to cancel the transform). 


Translation manipulator: 


Rotation manipulator: 
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Scale manipulator: 


For Light and camera objects, you can enter in “target mode” and move the target object without moving the 
camera or the light itself: 


All these manipulations are strictly equivalent to changing the parameters value directly in the Object Editor. You 
also need to apply initial values then if you want values to be saved. 
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3.8 Macro manager 


3.8.1 What is a macro? 


It is a tool designed to facilitate the development of a scenario. 
Macros are not part of the scenario and are not saved in the .dpd file. 


When a scenario is developed for a mobile platform, it can use devices such as accelerometer, compass, gps or 
touchscreen. 


When authoring in D'Fusion Studio, these devices do not exist but can be emulated with the Emulation settings 
dialog. 


The macro will allow these emulated devices to return values. 


3.8.2 Macro manager interface 


Macro manager displays all macros used for the current scenario. When the scene is closed, all macros are 
deleted. 


When scenario is saved, macros are saved. 


Each macro widget can be collapsed with the "Edit macro content" button. 


Macro manager 


Add a new macro 


Name Macro0 


Enabled Hardware device Data file 
0 Accelerometer C:/Users/ti/Desktop/fichiersInputstests/ValuesAccelerometer0.xml 
Compass 
Gps 
Touchscreen C:/Users/ti/Desktop/fichiersInputstests/ValuesTouchscreenO. xml 


© Keyboard C:/Users/ti/Desktop/fichiersInputstests/ValuesKeyboard0. xml 


[> ] Play macro 
ce Pause macro 
Oo Stop macro and reinitialize data 


Delete macro 
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3.8.4 Macro element 
A macro is composed of several elements. Each element represents a device. 
Enabled Enable the macro element. When macro is playing, all enabled 
element are evaluated 
Hardware device Only values for this device are evaluated. The little icon represents 
the device status: 
The device is available and 
emulated. 
The device is present natively so the 


data file will be not evaluated or the 
device is emulated but disabled 
forced 


The device is not available (the 
device is not present natively and its 
emulation is not activated) 


Data file A xml file which contains values for the current device. 
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3.9 Communication command simulation 


Communication command simulation is useful if your scenario communicates with a web page or high-level 
application (android/iphone). 


You can simulate a command pushed by a web page or an application and the log view permits to visualize 
commands received and emitted by the Lua scripts. 


Communication command simulation 


Add a command 


Commands: 


ScaleRobot Component Arguments 


Communication log: 


Add a command Add a new command in the command manager 


The panel "Communication command simulation" displays all commands used for the current scenario. When the 
scene is closed, all commands are deleted. When scenario is saved, commands are saved. 


When you push the button marked with the command's name, the current command is enqueued in its interface 
(WebInterface or Componentinterface) and could be received by Lua scripts. 


You can open the command edition dialog with the Edit button: 
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Add new argument 


OK = Cancel 


Name Command's name 
Type Command's type. Indicate if the command is received in Lua by 
the Componentinterface or the WebInterface 
Add new argument Add command's arguments 
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3.10 Solution explorer 


The solution explorer window displays the contents of your project folder as a tree view. Three view modes are 
available: File System, Media and User. 


3.10.1 File System 
Solution Explorer 


Current directory: £:\Dev\Te: 


View type: File system 


Geom 
[a Geom.material 342 octets 24/02/2011 16:40:47 


RB woodDiffuseMap.jpg 308.489 Ko 2 


#. config.config 0 octets 


BP. myScript.iua 0 octets 


B project.dpd 3.605 Ko 


Create a new directory on the disk. 


Import a directory in the current file hierarchy. 
Import files in the current file hierarchy. 
Delete current file/directory. 

Refresh resource files. 


Show/Hide hidden files. 


Expand or collapse items. 
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Files can have different status : 


P| Excluded file. This file is excluded form the export list of the 
current target/platform configuration. 

Missing file. This file is referenced in the export list of the current 
target/platform configuration but not present on the disk 

EF Hidden file. 


Several actions are allowed with right-click on items: 


Date modified 


Geom 
Copy file path 
Select first object with this resource 


Open in Lua Editor 


Include in export list 


Exclude from export list 


Edit resource properties 


Copy file path Copy the current file path in the clipboard 
Select first object with this Select an object in the scene which uses this resource file. 
resource 
Open in Lua Editor Open the current file in Lua Editor. 
Include in export list Include this file in the export list of the current target/platform 
configuration 
Exclude in export list Exclude this file from the export list of the current target/platform 
configuration 
Edit resource properties Open a dialog to edit export options (compressed/encypted...) for 
this file. 
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3.10.2 Media 
[Solution Explorer 


Current directory: E:\Dev\Te: 


View type: 


lm Scenettes 
3.198 Ko 28/03/2011 13:51:11 E:/Dev/Tests/test 


342 octets 24/02/2011 16:40:47 E:/Dev/Tests/test/Geom 
Textures 
L B woodDiffuseMap.jpg 308.489 Ko 24/02/2011 16:40:47 E:/Dev/Tests/test/Geom 
Overlays 


Compositors 


Particles 


LuaScripts 


Sounds 


Le 


Videos 


Fonts 


mi 


In this view, files are sorted by media types and only included files are displayed. 


You can easily find if several items have identical filenames. 


21/09/12 


In the media view, the only authorized operation is to delete items. You cannot create directories or import files. 


3.10.3 


Current directory: E:\Dev\Tests\test\ 
View type: User v = (wv) @ 
Size Date modified Path 


Geom.material 342 octets 24/02/2011 16:40:47 E:/Dev/Tests/test/Geom 
woodDiffuseMap.jpg 308.489 Ko 24/02/2011 16:40:47 E:/Dev/Tests/test/Geom 


myScript.lua s 28/03/2011 12:32:52 E:/Dev/Tests/test 
project.dpd 3. K 28/03/2011 13:51:11 E:/Dev/Tests/test 


In this view, you can organize the files as you want. You can create new directories, move files into directories by 
drag'n'drop. Created directories are "virtuals", they don't exist on the disk and the file hierarchy represented in 


this view is purely virtual too. It doesn't make change on the disk. 


However, if you delete a file, the file is physically deleted from the disk. 


3.10.4 Drag'n'drop resource in 3D View to create new objects 


If you drag'n'drop an item from the tree view to the 3D View, a new D'Fusion object is added to your scenario 


depending on the extension of the resource. 


22, rue Edouard Nieuport 92150 DFusion Studio - User guide.doc 
TOTAL SURESNES ? 


IMMERSION ® +33 (0) 1 46 25 97 42 
=| imersion.com 


53 / 73 


, D’Fusion® Studio 
TOTAL IMMERSION « ” een 21/09/12 


3.11 Export 


Target : mobile Platform : android 


Export folder : F:\Tests\TestApp07 


Encryption : 


file encryption 
Project default 
F:\Tests\DFusion\1-Objects\1-Objet3D\srcs\sc\Geom\Geom.material Project default 
F:\Tests\DFusion\1-Objects\1-Objet3D\srcs\sc\Geom\Geom.mesh Project default 
F:\Tests \DFusion\1-Objects\1-0 ...rcs\sc\Geom \woodDiffuseMap. jpg Project default 
F:\Tests \DFusion\1-Objects\1-Obje...srcs\sc\Primitives\frame.material Project default 
F:\Tests\DFusion\1-Objects\1-Objet3D\srcs\sc\Primitives\frame.mesh Project default 
F:\Tests\DFusion\1-Objects\1-Objet3D\srcs\sc\Primitives\grid.mesh — Project default 
F:\Tests \DFusion \1-Objects\1-Obje...rcs\sc\Primitives\helper.material 
F:\Tests \DFusion \1-Objects\1-Obj...s\sc\Primitives \world_helper.png 


F:\Tests\DFusion\1-Objects\1-Objet3D\srcs\sc\project.dpd Project default 


Once your scenario is ready, you can export it. Export will make a copy of all files you defined as part of the 
scenario and will generate a Test Software Key. The export view, accessible through the menu Project > Export 
lets you configure important data for your scenario deployment. 


The Export view shows you, for the selected target and platform, the list of files included in the project. If a file is 
missing, it is highlighted in dark red, but the export is still possible (a warning will remind you that you are 
exporting with some files missing). 


For Mobile applications, this view also allows you to set application ID that will be saved in the test software key. 


Target : Platform : android 


Export folder : F:\Tests \TestApp07 


Application ID : shadock07 


Encryption : none 


You can also choose the default encryption setting. Notice that this setting can be overridden independently for 
each file of the project. 


The application ID and encryption setting are project settings, saved within your .dpd file. 


For each target and platform you must also specify the folder where the project will be exported. Notice that this 
setting is considered more local to the environment development and thus not saved in the project file but in the 
workspace afferent file. 


When the configuration of your project is ready, clicking export will process (eg copy and eventually encrypt or 
compress) every file of the scenario to the export folder, and create automatically the test software key. Once 
you have exported your scenario, you can test it in real conditions on your mobile phone using D’Fusion Mobile 
SDK or on your computer using a D’Fusion player. 


To transform a “Test Software Key” (with Total Immersion tattoo) into a “Final Software key” 
(without Total Immersion tattoo), you need to purchase a D’Fusion Runtime license from Total 
Immersion. 
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4. LUA EDITOR PANEL 


The Lua Editor is an advanced text editor in which you can visualize and modify the Lua scripts associated to the 
scene scripts. It features a multiple-documents interface, classic search and replace feature, bookmarks and 
syntax highlighting. 


Besides it provides tools to debug the Lua scripts. 


File Edit Display Debug 
Locals 
moveObject.lua 


Name 
local scene = getCurrentScene() 


local geom = Entity (getCurrentScriptOwner()) 

local cam = Camera (scene: getObjectByNaem ("mod: Camera") ) 

local inTranslation false 

local inRotation = false 

local inScale false 

local inCosntraintX false 

local inConstraintY false 

local inConstraintZ false 

local step 0.01 

local inputManager = getInputManager () 

local keyboard = Keyboard (inputManager:getDevice (TIINPUT_KEYBOARDDEVICE) 
local mouse = Mouse (inputManager:getDevice (TIINPUT_MOUSEDEVICE) 


Lua Editor 


repeat 


local dx mouse: getXDisplacement () 
local dy mouse: getYDisplacement () 


if keyboard: wasKeyPressed(TIKEYBOARD SPACE) then 
if scene:getVisible() then scene:setVisible (false) 
else scene: setVisible (true) 
end 

end 


--What opearation? 
if keyboard: wasKeyPressed(TIKEYBOARD G) then 


1 
2 
3 
4 
5 
6 
4 
8 
i) 
10 
ua 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
2 


Cn \Locals 


Call Stack Find Results 


Function 


Lua Editor 
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4.1 Menu 
4.1.1 File 
New Ctr1l+N Create a new script, attach it to the scene, and set its Lua script 
Save Ctrl+s Save the script currently being edited 
Save all Ctrl+Shift+S — Save all open lua scripts 
4.1.2 Edit 
Undo Ctrl+Z Undo your last modification in the script currently being edited 
Redo Ctrity Redo your last modification in the script currently being edited 
Cut Ctr1l+Xx Insert the current selected text in the clipboard and deletes it 
Copy Ctrl+C Insert the currently selected text into the clipboard 
Paste Ctrl+V Inserts the clipboard content at the position of the text editor cursor 
Duplicate Ctrl+D Duplicate the currently selected text 
Un/Comment Ctrl+O Comment/Uncomment the currently selected text 
Find Ctrl+F Show the Find dialog box 
Replace CtrltH Show the Replace Dialog Box 
Go To Ctrl+G Show the Go To Line Dialog Box 


4.1.3 Display 


Switch view 


4.1.4 Debug 


Add/Remove 
breakpoint 


Toggle 
breakpoint 


Run 
Step 
Step in 


Step out 


TOTAL 
IMMERSION 


AlttV Split view in two panels 

Fg Add/Remove a breakpoint on the current line 

CErl+k9 Enable/disable a breakpoint on the current line 

PFS In break mode, resumes execution until next breakpoint 

F10 In break mode, executes current line of code and goes to next line 

F1l In break mode on a line containing a function call, executes only the call itself 


and then halts at the first line of code inside the function 


ShifttF1l Inside a function call, resumes execution of the current function until it returns, 
and then breaks at the return point in the calling function 
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4.2 Features 


4.2.1 Find/Replace Dialog 


ij Find and Replace 


Replace in all opened files 


S 
Whole Word Only [Search In 


Match Case Current Document 


Selection 
Search Upwards 


The find/replace dialog allows to quickly locate and optionally replace iterations of a given text string. 


Find Text to search for in the current document 
Replace With Text which will be used to replace the found text iterations 
Whole Word only If checked, only complete words will be considered when 


searching for the specified text, otherwise the text can be found 
as part of a word 


Match Case Makes the search case-sensitive 


Search Upwards If checked, will browse the text upwards when looking for the 
next iteration of the specified text string 


Search In If current Document is specified, the search will browse the whole 
lua script for iterations of the searched string. If Selection is 
checked, the string will only be searched in the currently selected 


text 

Find Next Searches and selects the next iteration of the string 

Replace Replace the currently selected iteration of the searched string if 
any, and then select the next searched string iteration 

Replace All Replaces all the searched string iterations with the text specified 
in “Replace With” 


When opening that dialog through the “Find” menu or the Ctri+F shortcut, the “Replace With”, “Replace” and 
“Replace All” fields will be disabled. 
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Line Number : 1-36 


The “Go to” dialog, available from the Edit menu, allows to quickly jump to a specific line in the currently opened 
document. 


4.2.2 Syntax Highlighting 


The editor will automatically color some specific text patterns for easier Lua code reading. Here is the meaning of 
the different default colors. 


Bold dark blue Lua key words (local, if, true...) 

Red Function/Method. If underlined, it means that the function is not 
recognized as a D’Fusion native function or method 

Brown Text string 

Green Comment 

Purple D’Fusion constant or enum 

Blue Lua native function and library methods (print, math.cos...) 


4.2.3 Bookmarks 


The Lua Editor allows you to add bookmarks to a script. Those bookmarks are markers which you can then later 
quickly jump to from anywhere else in the script. 
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{ij D'Fusion Studio 


File Edit Display Debug 


moveObject.lua * 


scene = getCurrentScene () 

geom = Entity (getCurrentScriptOwner () ) 

cam = Camera (scene: getObjectByNaem ("mod: Camera") ) 
inTranslation = false 

inRotation false 

inScale false 

inCosntraintX false 

inConstraintYy false 

inConstraintZ false 

step 0.01 

inputManager = getInputManager () 

keyboard = Keyboard (inputManager:getDevice (TIINPUT_KEYBOARDDEVICE) 
mouse = Mouse (inputManager:getDevice (TIINPUT_MOUSEDEVICE) 
scale = Vector3() 


Swomvnunpaune 


frame = Object3D (scene: getObjectByName ("Frame") ) 
geom0bj = Object3D(scene:getObjectByName ("Frame") ) 
grid = Object3D(scene:getObjectByName ("Grid") ) 


local dx = mouse:getXDisplacement () 


local dy mouse: getYDisplacement () 


Find Results 


Bookmarks are represented as blue squares in the document margin. To set a bookmark on a specific line, place 
the cursor on the line and press Ctr1+F2. 


Once one or several bookmarks are set, you can from anywhere in the script navigate between bookmarks by 
pressing the F2 key. 


4.2.4 Debug 


The Lua Editor allows to add breakpoints to a script. A breakpoint is a signal that tells the debugger to 
temporarily suspend execution of your program at a certain point. When execution is suspended at a breakpoint, 
the program is said to be in break mode. Entering break mode does not terminate or end the execution of the 
program. Execution can be resumed (continued) at any time. During the timeout of the break mode, the user can 
examine parameter values and states to look for violations (bugs). 
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Wj D'Fusion Studio 


File Edit Display 
Call Stack 
moveObject.lua |) sea 


Function 
scene = 


geom = ( Q) 
cam = (scene: ("mod:Camera" 
inTranslation = false 

inRotation = false 

inScale = false 

inCosntraintX = false 

inConstraintY false 

inConstraintZ false 

step = 0.01 

inputManager = () 
keyboard = (inputManager: 
mouse = (inputManager: 
scale ) 


Timeline 


WON OM BWN 


frame = (scene: ("Frame") 
geom0bj (scene: ("Frame 
grid = (scene: ("Grid") ) 


repeat 


local dx 
local dy 


Call Stack Locals 


Find Results 


Breakpoints are represented in the document margin as red disks when enabled, or red circles when disabled. 


To add/remove a breakpoint on a specific line, press F9, or use the menu Debug > Add/Remove breakpoint, or 
just click in the document margin. 


To enable/disable a breakpoint on a specific line, press C7RL+F9, or use the menu Debug > Toggle breakpoint. 


The current breaking line is underlined in yellow. 
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4.2.4.1 Variable windows 


The debugger provides a number of variable windows for displaying, evaluating, and editing variables and 
expressions. Each variable window includes a grid with two columns: Name and Value. The Name column 
contains variable names or expressions. The Va/ue column displays the value and data type of the variable or 
expression. When the variable is a D’Fusion object or a table, the Va/ve column begins by displaying the object 
type; an object type is displayed as follows : /7ype/([Scene/j, [Entity], [Camera], etc.) 


The type of information displayed in the grid depends on which variable window you are using: 


e The Locals window displays variables local to the current context or scope. Usually, this means the 
procedure or function you are currently executing. The debugger populates this window automatically. 
ocals 
Name Value 
P scene [Scene] 
P geom [Entity] 
P cam [Camera] 
inTranslation False 


inRotation False 


inScale 


inputManager 
keyboard 
mouse 
scale 
frame 
geomObj 
orid 

Lay 


Watch \Locals 


e The Watch window is where you can add variables whose value you want to watch. 


Value 
[Camera] 
foy ¥ 


near clip 


Watch Locals 
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4.2.4.2 Call Stack 


By using the Call Stack window, the user can view the function or procedure calls that are currently on the stack. 
The Call Stack window displays the name of each function and the file path of its source code. 


i D’Fusion Studio 


File Edit Display Debug 
Call Stack 
MyScript.lua (3%) aes 
Function 


llocal a = pe 
2 local b Ee oe 


aa func3 


5 function (a,b) 
6 local c=a+b 
7 g=c 

8 return c 

8S end 

10 

ii function (a,b) 
12 local c=a+z+b 
13 return (a,c) 
end 

15 


Timeline 


16 function (a,b) 
a b 


17 local c 
18 local d 
return d 


+ 


(@,c) 


22 coroutine.yield() 
23 
24 repeat 


Find Results 


Watch Locals 
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5. VIDEO PANEL 


Available from the “Studio” panel > “Tools” menu, the “Video” panel will allow you to configure your videocapture 
file. 


i) D’Fusion Studio - aa = 


File Edit 


Studio 


Resource path : 


Lua Editor 


Video File 
Device List USB 2.0 UVC 1.3M WebCam 


Timeline 


Num Driver 


Video 


Not interlaced 
Horizontal 


Pro Target : 

Currently defined camera 
@Home Target : 

Manual selection through a list at runtime 
Mobile Targets : 

Back camera 

Front camera 


Type Used framework for the videocapture 

Video file Let you define a video file if the videocapture is not a live video. 
Supported files depend on codec that are installed on the user 
computer. 

Device List Let you select directly the camera amongst available devices 

Num Driver Let you select directly the drive of the requested capture device 

Capture width Width of the videocapture 

Capture height Height of the videocapture 

Pixel format Pixel format of the videocapture 
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Rate Let you specify capture rate in fps (must be compliant with the 
device capabilities). 

Interlaced Let you define if the video must be deinterlaced. 

Inverted Let you define image flips. 

Delay Let you specify video capture delay (a number of frames). This 
delay is not taken into account for the tracking application. 

NbFrameBuffers Let you specify the size of the buffer to record video frames. 

Priority Let you specify the video capture thread priority. 

CPU Let you specify the video capture thread CPU. 

Saved Selection Mode Lets you define the camera device to use at playtime: 


- Pro target: use the device specified in “Device List”; 

- @Home target: the device to use can be chosen at runtime 
(start); 

- Mobile target - Back camera: use the Mobile back camera; 

- Mobile target - Front camera: use the Mobile front camera. 


Open Opens the videocapture. 


Close Closes the videocapture. 


See also the Computer Vision “Video Manager” panel documentation in [05] more information. 
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6. CAMERA CALIBRATION PANEL 


Available from the “Studio” panel > “Tools” menu, the “Camera Calibration” panel will allow you to specify the 
physical characteristics of your camera by configuring the camera calibration file. 


iJ D'Fusion Studio 


File — Edit 


Studio 


Resource path : 


Lua Editor 


[ The camera must match the video resolution 
to enable dedistortion. ] 


Timeline 


Camera Calibration 
Internal Parameters 
Max 
Focale 
Optical Center 
Distortion 
Radial 


Tangential 


See the D’Fusion Computer Vision “Distortion Manager” panel documentation in [05] for more information. 
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7. COMPUTER VISION PANEL 


Available from the “Studio” panel > “Tools” menu, the “Computer Vision” panel will allow you to create tracking 
scenarios. 


1 D'Fusion Studio 


File View Mode 


Studio 


VideoCapture Object: videocapture_live Camera Object: camera 


Scenario Manager | Tracking Manager | Output Manager 


Lua Editor 


Load Calibration 


w 
7] 
= 


Distortion 

Radial (a1, a2) 

Tangential (k1, k2) 
Activate distortion 

Preprocessing 

Processing size (x, y) 


Skip odd or even Frame 


Sub Image 


Use SubImage 


Video Rate: 30.30 fps 


Refer to the D’Fusion Computer Vision “Scenario Manager” panel documentation in [05] for more information. 
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8. 3D VIEWER PANEL 
Available from the “Studio” panel > “Tools” menu, the “3D Viewer” panel will allow you to review the 3D 
information of your scenette objects like mesh, animation and geometry. 


i D’Fusion Studio 


File Window Display 


Studio 


Animation 


timeline 


Lua Editor 


Time : 0.00 sec 


0.00 % 


a 
c 
~ 
= 


Animation Scene Info 


FPS : 40.00 
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9. APPENDIX: XML FILES FOR DEVICE EMULATION 


The behaviour of each device can be described in XML files. Then, these files can be used in D'Fusion Studio to 
simulate devices and help to debug a scenario. (cf macro manager section) 


The file contains all the events of the device. It begins with the root tag <dfusioninputdevice> and this tag is 
mandatory. 


9.1 Device 


You can define devices with the <device> tag. You can define several devices in a same file: 
<dfusioninputdevice> 


<device type="accelerometer"> 


</device> 


<device type="compass"> 


</device> 


</dfusioninputdevice> 


Device - Parameters 


Parameter : ‘type’ Type: ‘string’ MANDATORY 


Possible values are 
accelerometer 
compass 

gps 

Jevysrick 

gps 

keyboard 
mouse 
touchscreen 


VVVVVVVV 


Parameter : ‘id’ Type : ‘integer’ default value: “0” 


This parameter is evaluated if type="joystick". It the id of the joystick. 
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9.2 Accelerometer 


<device type="accelerometer"> 
<value accelY = "0" accelX = "-0.019444517791271" time = "4.736663" accelZ = "-1.1250041723251" /> 


</device> 


Accelerometer - Parameters 


Parameter : ‘time’ Type : ‘float’ MANDATORY 
Time of the value 


Parameter : ‘acce1X’ Type : ‘float’ MANDATORY 
X acceleration. Unit is G (gravity) 


Parameter : ‘accelY’ Type : ‘float’ MANDATORY 
Y acceleration. Unit is G (gravity) 


Parameter : “accel Z’ Type : ‘float’ MANDATORY 
Z acceleration. Unit is G (gravity) 


9.3 Compass 


<device type="compass"> 


<value oriY = "-1" time = "4.736663" accuracy = "-1" oriX = "0" heading = "0" oriZ = "0" /> 


</device> 


Compass - Parameters 


Parameter : ‘time’ Type : ‘float’ MANDATORY 
Time of the value 


Parameter : ‘oriX’ Type : ‘float’ MANDATORY 
X orientation in degrees 


Parameter : ‘oriY’ Type : ‘float’ MANDATORY 
Y orientation in degrees 


Parameter : ‘oriZ’ Type : ‘float’ MANDATORY 
Z orientation in degrees 


Parameter : ‘accuracy’ Type : ‘float’ MANDATORY 
Accuracy 
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Compass - Parameters 


Parameter : ‘heading’ 


Type: ‘float’ MANDATORY 


Angle between the phone direction and magnetic north in degrees 


9.4 Gps 


<device type="gps"> 


<value verticalaccuracy = "75" course = "0" horizontalaccuracy = "75" altitude = "0" longitude 
"2.2301833629608" timestamp = "1288780624523" speed = "0" latitude = "48.873119354248" /> 


</device> 


Gps - Parameters 


Parameter : ‘time’ 


Time of the value 


Altitude in meters 


Parameter : ‘speed’ 


Latitude in degrees 


Longitude in degrees. 


Parameter : “verticalaccuracy’ Type : ‘float’ MANDATORY 


Vertical accuracy in meters. A negative value indicates an invalid altitude. 


Parameter : ‘course’ 


Course in degrees from the north pole. A negative value indicates an invalid course. 


Parameter : “horizontalaccuracy’ Type: ‘float’ MANDATORY 


Horizontal accuracy in meters. A negative value indicates an invalid location 


Parameter : ‘altitude’ Type : ‘float’ MANDATORY 


Parameter : ‘longitude’ Dy perudaleaies MANDATORY 


Parameter : ‘timestamp’ Type: ‘float’ MANDATORY 


Time in seconds since January 1, 1970 of the last update. 


Speed in meters per second. A negative value indicates an invalid speed. 


Parameter : ‘latitude’ Type : ‘float’ MANDATORY 


Type: ‘float’ MANDATORY 


Type: ‘float’? MANDATORY 


Type: ‘float’ MANDATORY 
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9.5 Keyboard 
<device type="keyboard"> 
<value time="1.098017" > 
<event keycode="TIKEYBOARD_Q" virtualkey="TIKEYBOARD_A" pressed="true" /> 
</value> 
</device> 
Keyboard - Parameters 
Parameter : ‘time’ Type : ‘float’ MANDATORY 
Time of the value 
9.6 Touchscreen 
<device type="touchscreen"> 
<value time="7.272949" > 
<touch id="1" x="324.1237" y="154.1856" taps="1" /> 
</value> 
</device> 
Touchscreen - Parameters 
Parameter : ‘time’ Type : ‘float’ MANDATORY 
Time of the value 
Touchscreen touch - Parameters 
Parameter : ‘id’ Type : ‘integer’ MANDATORY 
Touch id 
Parameter : ‘x’ Type : ‘float’ MANDATORY 
Position x 
Parameter : ‘y’ Type : ‘float’ MANDATORY 
Position y 
Parameter : ‘taps’ Type : ‘integer’ MANDATORY 
Number of taps that corresponds to a given id 
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9.7 Mouse 


<device type="touchscreen"> 
<value time="1.098017" > 
<event controlid="0" value="17" /> 


<event controlid="3" value="true" /> 
</value> 


</device> 


Mouse - Parameters 


Parameter : ‘time’ Type : ‘float’ MANDATORY 


Time of the value 


Mouse event - Parameters 


Parameter : “controlid’ Type : ‘integer’ MANDATORY 
Time of the value 


Parameter : ‘value’ Type: ‘boolean’ or ‘integer’ MANDATORY 
True if the control is abutton and this button is pressed 

False if the control is a button and this button is released 

Integer value if the control is an axis (x, y, wheel) 
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9.8 Joystick 


<device type="joystick" id="0" > 
<value time="1.098017" > 
<event controlid="0" value="17" /> 


<event controlid="12" value="true" /> 
</value> 


</device> 


Joystick - Parameters 


Parameter : ‘time’ Type: ‘float’ MANDATORY 


Time of the value 


Joystick event -Parameters 


Parameter : “controlid’ Type: ‘integer’ MANDATORY 


Time of the value 


Parameter : ‘value’ Type: ‘boolean’ or ‘integer’ MANDATORY 


True if the control is abutton and this button is pressed 
False if the control is a button and this button is released 
Integer value if the control is an axis 
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